This chapter describes the GWCON process and includes the following sections:
The Gateway Console (monitoring) process, GWCON (also referred to as CGWCON), is a second-level process of the device user interface.
Using GWCON commands, you can:
The GWCON command interface is made up of levels called modes. Each mode has its own prompt. For example, the prompt for the SNMP protocol is SNMP>.
If you want to know the process and mode you are communicating with, press enter to display the prompt. Some commands in this chapter, such as the network and protocol commands, allow you to access the various modes in GWCON.
To enter GWCON from OPCON (*), choose one of the following methods:
* console
* status
Then, enter the talk command followed by the PID number for GWCON:
* talk 5
The console displays the GWCON prompt (+). If the prompt does not appear, press enter. Now you can enter GWCON commands.
To return to OPCON, enter the OPCON intercept character. (The default is Ctrl-P.)
This section contains the GWCON commands. Each command includes a description, syntax requirements, and an example. The GWCON commands are summarized in Table 19.
To use the GWCON commands, access the GWCON process by entering talk
5 and enter the GWCON commands at the (+) prompt.
Table 19. GWCON Command Summary
| Command | Function |
|---|---|
| ? (Help) | Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help". |
| Buffer | Displays information about packet buffers assigned to each interface. |
| Clear | Clears network statistics. |
| Configuration | Lists status of the current protocols and interfaces. |
| Disable | Takes the specified interface off line. |
| Error | Displays error counts. |
| Event | Enters the Event Logging System environment. |
| Feature | Provides access to console commands for independent device features outside the usual protocol and network interface console processes. |
| Interface | Displays network hardware statistics or statistics for the specified interface. |
| Memory | Displays memory, buffer, and packet data. |
| Network | Enters the console environment of the specified network. |
| Performance | Provides a snapshot of the main processor utilization statistics. |
| Protocol | Enters the command environment of the specified protocol. |
| Queue | Displays buffer statistics for a specified interface. |
| Reset | Disables the specified interface and then re-enables it using new interface, protocol and feature configuration parameters. |
| Statistics | Displays statistics for a specified interface. |
| Test | Enables a disabled interface or tests the specified interface. |
| Uptime | Displays time statistics for the device. |
Use the buffer command to display information about packet buffers assigned to each interface.
| Note: | Each buffer on a device is the same size and is dynamically built. Buffers vary in size from one device to another. |
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Syntax:
Example:
Notes:
| Note: | The number of receive buffers allocated is less than the number of receive buffers requested if there is not enough memory available to allocate the requested number of buffers. |
Use the clear command to delete statistical information about one or all of the device's network interfaces. This command is useful when tracking changes in large counters. Using this command does not save space or speed up the device.
Enter the interface (or net) number as part of the command. To get the interface number, use the GWCON configuration command.
Syntax:
Use the configuration command to display information about the protocols and network interfaces. The output is displayed in three sections, the first section lists the device identification, software version, boot ROM version, and the state of the auto-boot switch. The second and third sections list the protocol and interface information.
Syntax:
Example:
The following information is displayed for protocols:
The following information is displayed for features:
The following information is displayed for networks:
When an interface is operational, the interface periodically sends out maintenance packets and/or checks the physical state of the port or line to ensure that the interface is still functioning correctly. If the maintenance fails, the interface is declared down and a self-test is scheduled to run in 5 seconds. If a self-test fails, the interface transitions to the down state and the interval until the next self-test is increased up to a maximum of 2 minutes. If the self-test is successful, the network is declared up.
When an interface is disabled, it remains disabled until one of the following methods is used to enable it:
Not Present is also used as the state for a null device. Spare interfaces are displayed as null devices until they are activated.
Use the disable command to take a network interface off-line, making the interface unavailable. This command immediately disables the interface. You are not prompted to confirm, and no verification message displays. If you disable an interface with this command, it remains disabled until you use the GWCON test command or an OPCON reload command to enable it.
Enter the interface or net number as part of the command. To obtain the interface number, use the GWCON configuration command.
Syntax:
Use the error command to display error statistics for the network. This command provides a group of error counters.
Syntax:
Example:
| Note: | The sum of the discarded output packets is not the same as input flow drops over all networks. Discarded output may indicate locally originated packets. |
Use the event command to access the Event Logging System (ELS) console environment. This environment is used to set up temporary message filters for troubleshooting purposes. All changes made in the ELS console environment will take effect immediately, but will go away when the device is reinitialized. See "Using the Event Logging System (ELS)" for information about the Event Logging System and its commands. Use the exit command to return to the GWCON process.
Syntax:
Use the feature command to access console commands for specific IBM 8371 features outside of the protocol and network interface console processes.
Enter a question mark after the feature command to obtain a listing of the features available for your software release.
To access that feature's console prompt, enter the feature command at the GWCON prompt followed by the feature number or short name. Table 15 lists available feature numbers and names.
Once you access the prompt for that feature, you can begin entering specific commands to monitor that feature. To return to the GWCON prompt, enter the exit command at the feature's console prompt.
Syntax:
Use the interface command to display statistical information about the network interfaces (for example, Ethernet). This command can be used without a qualifier to provide a summary of all the interfaces or with a qualifier to reveal detailed information about one specific interface.
Descriptions of detailed output for each type of interface are provided in the specific interface Monitoring chapters found in this guide. To obtain the interface number, use the GWCON configuration command.
Syntax:
Example: interface
| Note: | The following information may be displayed. The display varies depending on the device. |
Use the memory command to display the current CPU memory usage in bytes, the number of buffers, and the packet sizes.
To use this command, free memory must be available. The number of free packet buffers may drop to zero, resulting in the loss of some incoming packets; however, this does not adversely affect device operations. The number of free buffers should remain constant when the device is idle. If it does not, contact your service representative.
Syntax:
Example:
memory
Physical installed memory: 16 MB
Total routing (heap) memory: 12 MB
Routing memory in use: 13 %
Total Reserve Never Perm Temp Prev
Alloc Alloc Alloc Alloc
Heap memory 12231155 26488 10687312 1438487 104924 432
Number of global buffers: Total = 300, Free = 300, Fair = 77, Low = 60
Global buff size: Data = 2048, Hdr = 17, Wrap = 72, Trail = 65, Total = 2208
Number of global buffers:
Use the network command to enter the console environment for supported networks. This command obtains the console prompt for the specified interface.
Syntax:
At the GWCON prompt (+), enter the configuration command to see the protocols and networks for which the device is configured. See "Configuration" for more information on the configuration command.
Enter interface at the + prompt for a display of the networks for which the device is configured.
Enter the GWCON network command and the number of the interface you want to monitor or change. For example:
+network 0
ATM+
In the example, the ATM+ prompt is displayed. You can then view information about the ATM interface by entering the ATM operating commands.
After identifying the interface number of the interface you want to monitor, for interface-specific information, see the corresponding monitoring chapter in this manual for the specified network or link-layer interface. Console support is offered for the following network and link-layer interfaces:
Use the performance command at the GWCON prompt to enter the monitoring environment for performance. See "Configuring and Monitoring Performance" for more information.
Use the protocol command to communicate with the device software that implements the network protocols installed in your device. The protocol command accesses a protocol's command environment. After you enter this command, the prompt of the specified protocol appears. From the prompt, you can enter commands that are specific to that protocol.
Syntax:
Enter the protocol number or short name as part of the command. To obtain the protocol number or short name, enter the CONFIG command environment (Config>), and then enter the list configuration command. See "Accessing the Configuration Process, CONFIG (Talk 6)" for instructions on accessing Config>. To return to GWCON, enter exit.
See the corresponding monitoring chapter in this manual or in the Protocols and Features for information on a specific protocol's console commands.
Use the queue command to display statistics about the length of input and output queues on the specified interfaces. Information about input and output queues provided by the queue command includes:
Syntax:
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Input Queue:
Output Queue:
| Note: | When Bandwidth Reservation (BRS) is configured for PPP and Frame Relay interfaces, the output fair value is ignored and the queue lengths configurable with BRS are used to determine if a packet should be discarded due to flow control. |
If a packet is received and the input queue current value is less than the input queue low threshold value, then the packet will be subject to flow control. For locally originated packets, a packet is subject to flow control if the number of free global buffers is less than the low threshold for global buffers. If a packet subject to flow control is to be transmitted on a device which has an output queue current value that is greater than the output queue high threshold (fair), then the packet is dropped instead of queued. When a packet is dropped due to flow control, the output discards counter is incremented and ELS event GW.036 or GW.057 is logged. If the packet was not locally originated, the input flow drop counter for the input interface is incremented. The output discards and input flow drop counters are displayed by the GWCON error command.
Due to the scheduling algorithms of the device, the dynamic numbers of Curr (particularly the Input Queue Curr) may not be fully representative of typical values during packet forwarding. The console code runs only when the input queues have been drained. Thus, Input Queue Curr will generally be nonzero only when those packets are waiting on slow transmit queues.
Use the reset command to disable the specified interface and then re-enable it using new interface, protocol and feature configuration parameters. See "Resetting Interfaces" for more information.
Syntax:
Use the statistics command to display statistical information about the network software, such as the configuration of the networks in the device.
Syntax:
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Example:
Use the test command to verify the state of an interface or to enable an interface that was previously disabled with the disable command. If the interface is enabled and passing traffic, the test command will remove the interface from the network and run self-diagnostic tests on the interface.
Syntax:
| Note: | For this command to work, you must enter the complete name of the command followed by the interface number. |
Enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command. For example, when testing starts, the console displays the following message:
Testing net 0 Eth/0...
When testing completes or fails, or when GWCON times out (after 30 seconds), the following possible messages are displayed:
Testing net 0 Eth/0 ...successful Testing net 0 Eth/0 ...failed Testing net 0 Eth/0 ...still testing Testing net 0 ATM/0 ...successful Testing net 0 ATM/0 ...failed Testing net 0 ATM/0 ...still testing Network is already undergoing test, attempting restart
Some interfaces may take more than 30 seconds before testing is done.
Use the uptime command to display time elapsed since the last reload.
Syntax: